《Android开源库》 MPAndroidChart Wiki(译文)～Part 4

16. 动画

注意：本章的动画效果只会在API 11（Android3.0.x）及以上的Android版本上生效
在低于上述的Android版本中，动画将不会被执行，并不会导致程序崩溃。

mChart.animateX(3000); // animate horizontal 3000 milliseconds
// or:
mChart.animateY(3000); // animate vertical 3000 milliseconds
// or:
mChart.animateXY(3000, 3000); // animate horizontal and vertical 3000 milliseconds

任意一种 animate(…) 动画方法被调用后，无需再调用 invalidate() 方法。

16.1 缓动动画

这个库可以让你对动画应用”缓动函数”。
你可以选择以下预定义的静态 Easing.EasingOption :

public enum EasingOption {
    Linear,
    EaseInQuad,
    EaseOutQuad,
    EaseInOutQuad,
    EaseInCubic,
    EaseOutCubic,
    EaseInOutCubic,
    EaseInQuart,
    EaseOutQuart,
    EaseInOutQuart,
    EaseInSine,
    EaseOutSine,
    EaseInOutSine,
    EaseInExpo,
    EaseOutExpo,
    EaseInOutExpo,
    EaseInCirc,
    EaseOutCirc,
    EaseInOutCirc,
    EaseInElastic,
    EaseOutElastic,
    EaseInOutElastic,
    EaseInBack,
    EaseOutBack,
    EaseInOutBack,
    EaseInBounce,
    EaseOutBounce,
    EaseInOutBounce,
}

基本上，有以下两种方式进行 easing 你的动画。

预定义的缓动选项：（下面代码可在所有 Android 版本运行）

1	public void animateY(int durationmillis, Easing.EasingOption option);

例如，调用带有预定义缓动选项的动画方法

1 2	// animate both axes with easing mChart.animateY(3000, Easing.EasingOption.EaseOutBack);

当你想代码运行在 Android 3.0 (API 11) 以下时，要使用 Easing.EasingOption 。

自定义缓动函数（在 Android 3.0 自定义缓动函数会使应用 crash）：

1	public void animateY(int durationmillis, EasingFunction function);

通过创建你自己的easing-function类并且实现EasingFunction接口，你可以实现你自己的easing功能

/**
 * Interface for creating custom made easing functions. 
 */
 public interface EasingFunction {
    /**
     * Called everytime the animation is updated.
     * @param input - the time passed since the animation started (value between 0 and 1)
     */
     public float getInterpolation(float input);
 }

然后，按照如下方式使用(注意，这个不能在小于Android3.0的版本上使用，将会导致程序崩溃)

1 2	// animate both axes with easing mChart.animateY(3000, new MyEasingFunction());

17. IMarker接口

自版本v3.0.0以来，图表中的标记（弹出窗口）由IMarker接口表示。

17.1 IMarker接口

这个接口可以帮助你实现在图表中条目高亮的时候显示自定义的Marker窗口。这个接口给我们提供了如下需要实现的方法：

public interface IMarker {

    /**
     * @return The desired (general) offset you wish the IMarker to have on the x- and y-axis.
     *         By returning x: -(width / 2) you will center the IMarker horizontally.
     *         By returning y: -(height / 2) you will center the IMarker vertically.
     */
    MPPointF getOffset();

    /**
     * @return The offset for drawing at the specific `point`. This allows conditional adjusting of the Marker position.
     *         If you have no adjustments to make, return getOffset().
     *
     * @param posX This is the X position at which the marker wants to be drawn.
     *             You can adjust the offset conditionally based on this argument.
     * @param posY This is the X position at which the marker wants to be drawn.
     *             You can adjust the offset conditionally based on this argument.
     */
    MPPointF getOffsetForDrawingAtPos(float posX, float posY);

    /**
     * This method enables a specified custom IMarker to update it's content every time the IMarker is redrawn.
     *
     * @param e         The Entry the IMarker belongs to. This can also be any subclass of Entry, like BarEntry or
     *                  CandleEntry, simply cast it at runtime.
     * @param highlight The highlight object contains information about the highlighted value such as it's dataset-index, the
     *                  selected range or stack-index (only stacked bar entries).
     */
    void refreshContent(Entry e, Highlight highlight);

    /**
     * Draws the IMarker on the given position on the screen with the given Canvas object.
     *
     * @param canvas
     * @param posX
     * @param posY
     */
    void draw(Canvas canvas, float posX, float posY);
}

17.2 创建一个标记视图

为了创建一个自定义的标记视图，你需要创建一个实现了IMarker接口的类：

1	public class YourMarkerView implements IMarker { ... }

实现IMarker接口时返回什么样的值，完全取决于你自己的需求。所以，看看上面关于每个方法的介绍是很有必要的。

除了通过实现IMarker接口来创建自己的标记视图，我们还可以通过继承下面提到的一个类来达到同样的目的。这个方法比较简单，并且我们也不需要实现IMarker接口中的所有方法。只有几个特定的方法需要我们复写和自定义。最重要的是复写refreshContent（…）方法来调整标记视图中的数据。一个简单的示例如下：

public class YourMarkerView extends MarkerView {

    private TextView tvContent;

    public MyMarkerView(Context context, int layoutResource) {
        super(context, layoutResource);

        // find your layout components
        tvContent = (TextView) findViewById(R.id.tvContent);
    }

    // callbacks everytime the MarkerView is redrawn, can be used to update the
    // content (user-interface)
    @Override
    public void refreshContent(Entry e, Highlight highlight) {

        tvContent.setText("" + e.getY());

        // this will perform necessary layouting
        super.refreshContent(e, highlight);
    }

    private MPPointF mOffset; 

    @Override
    public MPPointF getOffset() {

        if(mOffset == null) {
           // center the marker horizontally and vertically
           mOffset = new MPPointF(-(getWidth() / 2), -getHeight());
        }

        return mOffset;
    }
}

17.3 获取／设置Marker

给图表设置一个Marker，使用setMarker(…)方法：

1 2	IMarker marker = new YourMarkerView(); chart.setMarker(marker);

要访问图表上的一个Marker，使用getMarker()方法：

1	IMarker marker = chart.getMarker();

17.4 预定义Markers

除了你自定义的MarkerView，开源库中也给我们提供了几个预定义的markers以供方便快捷的使用。其中包括：

MarkerView :基本marker。允许提供布局文件作为图表上呈现的标记。继承这个类并且复写refreshContent(…)方法来调整标记视图中的内容。
MarkerImage:一种绘制图片的标记视图。允许提供一个图片资源作为图表上的标记视图。继承这个类并且复写refreshContent(…)方法来调整标记视图中的内容。

17.5 旧版MarkerView

版本v3.0.0 之前，MarkerView类负责在图表高亮部分绘制标记视图。详情请查阅老版的the old MarkerView wiki page.

18. ChartData类

本章旨在让你更深入的了解MPAndroidChart中的数据模型。

ChartData类是像LineData，BarData等等这些数据类的父类。setData()方法可以将数据设置到图表中。

1	public class LineData extends ChartData { ...}

下面介绍一些ChartData类中的方法，可以直接在它的子类中使用。

18.1 数据样式

方法	使用
setValueTextColor(int color)	设置 DataSets 数据对象包含的数据的值文本的颜色
setValueTextColors(List colors)	设置一个颜色列表用于显示值
setValueTextSize(float size)	设置 DataSets 数据对象包含的数据的值文本的大小（单位是dp）
setValueTypeface(Typeface tf)	设置 DataSets 数据对象包含的数据的值文本的字体
setValueFormatter(ValueFormatter f)	为DataSets 数据对象包含的数据设置自定义的 ValueFormatter。更多关于ValueFormatter，请查阅此处
setDrawValues(boolean enabled)	启用/禁用绘制所有 DataSets 数据对象包含的数据的值文本
********
### 18.2 Getter方法
方法	使用
——–	———
getDataSetByIndex(int index)	返回目标 DataSet 列表中给定索引的数据对象。
contains(Entry entry)	检查此数据对象是否包含指定的Entry 。注：这个相当影响性能，性能严峻情况下，不要过度使用。
contains(T dataSet)	如果数据中包含指定dataSet,返回true否则返回false
********
### 18.3 清除
方法	使用
——–	———
clearValues()	清除所有 DataSet 对象和所有 Entries 的数据。不会删除所提供的 x-values
********
### 18.4 选中高亮
方法	使用
——–	———
setHighlightEnabled(boolean enabled)	设置为true，允许通过点击高亮突出 ChartData 对象和其 DataSets
setDrawVerticalHighlightIndicator(boolean enabled)	启用／即用纵向选中高亮指示线。如果禁用，指示线将不会被绘制
setDrawHorizontalHighlightIndicator(boolean enabled)	用／即用横向选中高亮指示线。如果禁用，指示线将不会被绘制
********
### 18.5 动态数据
方法	使用
——–	———
notifyDataChanged()	通知数据对象，底层数据发生变化，候执行所有必需的计算